home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / doorware / kspslp37.zip / KSP-SLIP.DOC < prev    next >
Text File  |  1996-10-03  |  67KB  |  1,917 lines
  1.  
  2.  
  3.         
  4.  
  5.  
  6.                                   KSP SLIP (tm)
  7.  
  8.                      A SLIP Door for Bulletin Board Systems
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    Version 3.7
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                               Copyright (C) 1995-96
  31.                                All Rights Reserved
  32.  
  33.  
  34.                                        by
  35.  
  36.  
  37.                               KEY SOFTWARE PRODUCTS
  38.  
  39.                                 40 Atherton Court
  40.                          Redwood City, California 94061
  41.                               BBS/FAX: 415-364-9847
  42.  
  43.  
  44.  
  45.                 KSP SLIP is a trademark of Key Software Products.
  46.                  PCL4C is a trademark of MarshallSoft Computing.
  47.                      WATTCP is a trademark of Erick Engelke.
  48.                      Power C is a trademark of Mix Software.
  49.                      Multi-C is a trademark of Mix Software.
  50.              DESQview is a trademark of Quarterdeck Office Systems.
  51.                    Lantastic is a trademark of Artisoft, Inc.
  52.                       Novell is a trademark of Novell Corp.
  53.                    Banyan Vines is a trademark of Banyan Inc.
  54.  
  55.  
  56.  
  57.  
  58.         
  59.  
  60.  
  61.                                 TABLE OF CONTENTS
  62.  
  63.  
  64.  
  65.         CHAPTER 1 - INTRODUCTION        ...........................    1
  66.            1.1  Compatibility with BBS Software     ...............    2
  67.            1.2  Hardware Requirements       .......................    2
  68.            1.3  Software Requirements       .......................    2
  69.            1.4  Other KSP Software      ...........................    3
  70.               1.4.1  KSP Telnet       .............................    3
  71.               1.4.2  KSP FTP       ................................    3
  72.               1.4.3  KSP Mail       ...............................    3
  73.               1.4.4  KSP HOST       ...............................    3
  74.               1.4.5  So Many CD's      ............................    4
  75.  
  76.         CHAPTER 2 - INSTALLATION        ...........................    5
  77.            2.1  Packet Driver Shims for Novell    .................    5
  78.            2.2  Packet Driver Shim for Novell w/Token-RingSNAP   ..    6
  79.            2.3  Packet Driver Shims for Lantastic    ..............    6
  80.               2.3.1  Changes to CONFIG.SYS      ...................    6
  81.               2.3.2  Changes to PROTOCOL.INI      .................    7
  82.            2.4  Packet Driver Shims for Banyan Vines   ............    8
  83.            2.5  Other Things to Configure     .....................    8
  84.  
  85.         CHAPTER 3 - THE WATTCP CONFIGURATION FILE     .............    9
  86.            3.1  Multiple Nodes and the "include" Directive   ......   10
  87.            3.2  Using a BOOTP Server     ..........................   10
  88.            3.3  Manual Configuration       ........................   10
  89.               3.3.1  The PC's Host Name     .......................   11
  90.               3.3.2  The PC's Domain Name     .....................   11
  91.               3.3.3  The PC's IP Address     ......................   11
  92.               3.3.4  The Name Server's IP Address    ..............   12
  93.               3.3.5  The Router's IP Address     ..................   12
  94.               3.3.6  The PC's Network Mask     ....................   12
  95.            3.4  TCP/IP Parameters (optional)      .................   12
  96.               3.4.1  Timeouts        ..............................   13
  97.               3.4.2  Maximum Segment Size (MSS)     ...............   13
  98.            3.5  SLIP Operating Parameters      ....................   13
  99.               3.5.1  Dynamic Parameters       .....................   14
  100.               3.5.2  Blocking Access to Certain Sites    ..........   14
  101.               3.5.3  Exceptions to Blocking      ..................   16
  102.               3.5.4  Combining Blocking + Forwarding + Exceptions     16
  103.               3.5.5  Session Time Limit      ......................   17
  104.               3.5.6  Session Reserve Time      ....................   17
  105.               3.5.7  Inactivity Limit       .......................   17
  106.               3.5.8  Minimum Baud Rate      .......................   18
  107.               3.5.9  Operating Hours       ........................   18
  108.               3.5.10  Startup Message       .......................   18
  109.               3.5.11  Minimum Baud Rate Message     ...............   19
  110.               3.5.12  Operating Hours Message      ................   19
  111.               3.5.13  User Session Logging      ...................   19
  112.               3.5.14  SLIP Packet Monitor      ....................   19
  113.  
  114.  
  115.  
  116.         
  117.  
  118.  
  119.                                 TABLE OF CONTENTS
  120.  
  121.  
  122.               3.5.15  Non-Standard Port/Fossil Break Detect     ...   20
  123.               3.5.16  Eliminating the Startup Count-Down     ......   20
  124.               3.5.17  Silencing the BBS console bell    ...........   20
  125.               3.5.18  Disabling the Local Screen     ..............   21
  126.               3.5.19  Hanging Up When Exiting From the Door  ......   21
  127.  
  128.         CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND    ...........   22
  129.            4.1  Command Line Parameters      ......................   22
  130.               4.1.1  The /MAXMINS Parameter      ..................   22
  131.               4.1.2  The /CONFIG Parameter      ...................   22
  132.               4.1.3  KSP-SLIP.EXE Exit Codes      .................   23
  133.               4.1.4  Checking Packet Counts (PKTCOUNT.EXE)     ....   23
  134.  
  135.         CHAPTER 5 - INSTALLING YOUR ACCESS KEY     ................   24
  136.  
  137.         CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES     .............   25
  138.            6.1  PCBoard Display Macros      .......................   25
  139.            6.2  Macros Unique to KSP SLIP    ......................   25
  140.            6.3  Justification and Spacing      ....................   25
  141.               6.3.1  No Justification       .......................   26
  142.               6.3.2  Left Justification       .....................   26
  143.               6.3.3  Center Justification       ...................   26
  144.               6.3.4  Right Justification       ....................   26
  145.            6.4  The DISPLAY Program      ..........................   27
  146.  
  147.         APPENDIX 1 - HOW TO REACH US     ..........................   28
  148.  
  149.         APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    ..........   29
  150.  
  151.         APPENDIX 3 - LEGAL STUFF       ............................   30
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.         
  175.  
  176.  
  177.  
  178.         Oct 03, 1996           KSP SLIP (tm) v3.7                       1
  179.  
  180.  
  181.                         CHAPTER 1 - INTRODUCTION        
  182.  
  183.  
  184.         Many  BBS's  now offer E-Mail access to the Internet.  But few if
  185.         any  offer  a real TCP/IP connection.  As compared to mere E-Mail
  186.         access,  providing a TCP/IP connection opens up a large number of
  187.         new  possibilities  to  callers,  such  as  the ability to remote
  188.         login  to Internet hosts in foreign countries using Telnet, or to
  189.         access  files  on  those  hosts  using  FTP,  or  to  search  for
  190.         information   using   Gopher,  Archie,  and  the  new  multimedia
  191.         hypertext browser, Mosaic.  
  192.  
  193.         KSP  SLIP  establishes  a  logical two-way connection between the
  194.         user's serial line and the Internet: 
  195.  
  196.                             +----------+     |
  197.                User's       |          |     | Local Area Network
  198.                Modem <----->| KSP SLIP |<----+ connected to the
  199.                             |          |     | Internet
  200.                             +----------+     |
  201.                             BBS Machine
  202.  
  203.         As  indicated,  the  physical  connection between the BBS machine
  204.         and  the  Internet  is  usually  by  means  of  an  Ethernet card
  205.         attached  to  a  local  area  network  that  is  attached  to the
  206.         Internet.   However,  this  connection  could instead be simply a
  207.         separate   modem  connection  to  a  commercial  Internet  access
  208.         provider, such as NETCOM.  
  209.  
  210.         TCP/IP  encapsulates  data in packets and transfers those packets
  211.         according  to  a  specific  communication  protocol.  Data on the
  212.         serial  line  between  the  BBS  and  the  caller  must obey this
  213.         protocol;  KSP  SLIP  does  this  using a popular protocol called
  214.         SLIP  (Serial Link Internet Protocol).  Of course the caller must
  215.         also  be using software at his end that also supports SLIP; there
  216.         are  several  shareware products for this purpose, available from
  217.         the Key Software Products BBS.  
  218.  
  219.         KSP SLIP meets the following BBS-specific needs: 
  220.  
  221.              1.  Terminates  the  BBS session when user's time limit
  222.                      expires.  
  223.              2.  Terminates the BBS session when user hangs up.  
  224.              3.  Terminates   when   there's   no   activity  for  a
  225.                      sysop-specified period of time.  
  226.              4.  Records the SLIP session in a log file.  
  227.              5.  Provide  colorized  or  parameterized  messages  to
  228.                      user.  
  229.  
  230.  
  231.  
  232.  
  233.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  234.  
  235.  
  236.         Oct 03, 1996           KSP SLIP (tm) v3.7                       2
  237.  
  238.  
  239.              6.  Restrict users by baud rate.  
  240.              7.  Restrict hours of operation.  
  241.  
  242.         KSP   SLIP   is  shareware.   The  unlicensed  version  is  fully
  243.         functional  except  that it imposes a maximum of five minutes per
  244.         SLIP  session.   Once  licensed,  the user is limited only by the
  245.         amount of time remaining in his BBS session.  
  246.  
  247.         KSP  SLIP  was  implemented  using  Erick  Engelke's Waterloo TCP
  248.         library,  MarshallSoft  Computing's PCL4C Personal Communications
  249.         library,   and  Mix  Software's  Power  C  compiler  and  Multi-C
  250.         multi-threaded code library.  
  251.  
  252.  
  253.         1.1 Compatibility with BBS Software      
  254.  
  255.         KSP  SLIP is compatible with any BBS software that can generate a
  256.         DOOR.SYS  file.   It  works  with  a  BBS  configured  to use the
  257.         standard  COM1  through  COM4 ports, or will automatically detect
  258.         and use a Fossil driver.  
  259.  
  260.  
  261.         1.2 Hardware Requirements        
  262.  
  263.         KSP  SLIP  inherently  requires  that  the  PC  running  your BBS
  264.         software  have  a  physical  connection  to  a  TCP/IP  network -
  265.         normally  the  Internet.  Ideally, this connection is by means of
  266.         an  adapter  card  connected  to  an  Ethernet at your company or
  267.         school (and then through a "gateway" to the Internet).  
  268.  
  269.         It  is  also  possible  to  connect  to  the  Internet  through a
  270.         commercial  Internet  Access  Provier  via a dial-up SLIP (Serial
  271.         Line  Internet  Protocol)  connection.   This approach requires a
  272.         second  serial  port, modem, and telephone line dedicated to this
  273.         purpose.   Information on finding such a provider is available on
  274.         the KSP BBS.  
  275.  
  276.  
  277.         1.3 Software Requirements        
  278.  
  279.         KSP  SLIP  runs  on  top  of  another  piece of software called a
  280.         "packet  driver".  The packet driver presents a standard software
  281.         interface  to  KSP  SLIP,  regardless  of  the  type  of hardware
  282.         interface  that  connects  the  PC to the network.  Public domain
  283.         packet drivers exist for SLIP links and most Ethernet cards.  
  284.  
  285.         If  your  BBS  uses  a  multi-tasking  operating  system  to  run
  286.         multiple  nodes  on  a  single  PC,  then you will need a "packet
  287.         multiplexer".   A  packet  multiplexer  designed specifically for
  288.  
  289.  
  290.  
  291.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  292.  
  293.  
  294.         Oct 03, 1996           KSP SLIP (tm) v3.7                       3
  295.  
  296.  
  297.         use   with   KSP  network  products  running  under  DESQview  is
  298.         available  as  a  freeware  package  distributed  as KSPMUX*.ZIP,
  299.         where  the  "*"  is  the  version  number.   KSP SLIP is DESQview
  300.         "aware"   to   provide   better  performance  in  a  multitasking
  301.         environment.  
  302.  
  303.         If  your  PC  is  connected  to  a non-TCP/IP proprietary network
  304.         (such  as  Novell  or Lantastic), you will probably need a packet
  305.         driver "shim".  
  306.  
  307.         KSP  SLIP  does  NOT  require that you purchase a separate TCP/IP
  308.         package,  such  as  that  sold  by Novell, Artisoft, or IBM.  KSP
  309.         SLIP   should   happily  coexist  with  any  of  these  packages,
  310.         however.  
  311.  
  312.         An  assortment of public domain packet drivers, multiplexers, and
  313.         shims are available on the KSP BBS.  
  314.  
  315.  
  316.         1.4 Other KSP Software       
  317.  
  318.         Key  Software  Products  offers  a  number  of other products for
  319.         BBS's: 
  320.  
  321.  
  322.         1.4.1 KSP Telnet        
  323.  
  324.         A   door  program  that  allows  callers  to  connect  to  remote
  325.         computers  anywhere  on the Internet via your BBS.  Available now
  326.         on our BBS.  
  327.  
  328.  
  329.         1.4.2 KSP FTP        
  330.  
  331.         A  door  program  that  allows  callers to transfer files to/from
  332.         remote computers anywhere on the Internet via your BBS.  
  333.  
  334.  
  335.         1.4.3 KSP Mail        
  336.  
  337.         A  Multi-Threaded  Server  for  SMTP  Mail  and NNTP Usenet news.
  338.         Replaces  UUCP,  its  monthly  fees,  and slow transfer rates! No
  339.         more  unwanted  newsgroups!  Instant  mail  without  waiting  for
  340.         scheduled  events!   Works  with  any BBS software that presently
  341.         uses  UUCP.   Requires a 24hr TCP/IP Internet connection. Can now
  342.         receive NNTP news feeds! 
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  350.  
  351.  
  352.         Oct 03, 1996           KSP SLIP (tm) v3.7                       4
  353.  
  354.  
  355.         1.4.4 KSP HOST        
  356.  
  357.         An  inbound  Telnet  server  for  MS/DOS  Bulletin Board Systems.
  358.         Every  node  can  answer both telnet and modem calls!  Requires a
  359.         fossil  driver  on  each node, a 24 hour TCP/IP connection to the
  360.         Internet,  and a local area network that supports NetBios such as
  361.         Novell or Lantastic.  
  362.  
  363.  
  364.         1.4.5 So Many CD's       
  365.  
  366.         A  PCBoard PPE to handle off-line CD-Roms.  Seamlessly integrated
  367.         into  PCBoard.   Users  post requests for off-line files and have
  368.         then  returned  as  attachments to messages. Configurable message
  369.         pack-out  dates  automatically  keep  your hard disk from getting
  370.         cluttered.  Available now on our BBS.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  408.  
  409.  
  410.         Oct 03, 1996           KSP SLIP (tm) v3.7                       5
  411.  
  412.  
  413.                         CHAPTER 2 - INSTALLATION        
  414.  
  415.  
  416.         Before  installing  KSP  SLIP  as  a  BBS  door,  you  must first
  417.         install: 
  418.  
  419.              1.  The network interface hardware.  
  420.              2.  A corresponding packet driver.  
  421.              3.  A packet driver shim (if needed).  
  422.              4.  A packet multiplexer (if needed).  
  423.  
  424.         Detailed  directions for these preliminary steps are available in
  425.         separate   documentation   that   comes  with  the  corresponding
  426.         hardware or software.   
  427.  
  428.         It's  most  common  that multi-node BBS's are interconnected with
  429.         Ethernet  and  either  Lantastic or Novell.  Unfortunately, these
  430.         two  network  operating  systems  were  designed  using their own
  431.         proprietary  protocols  rather than the TCP/IP protocol and their
  432.         own  proprietary  software  rather than packet drivers to talk to
  433.         their  Ethernet  interface  cards.   However, a piece of software
  434.         called  a packet driver "shim" can be used to let both TCP/IP and
  435.         their proprietary protocol coexist.  
  436.  
  437.  
  438.         2.1 Packet Driver Shims for Novell     
  439.  
  440.         Novell's  network  software is installed in layers as TSRs in the
  441.         order  shown  below.   These commands are usually found either in
  442.         the  AUTOEXEC.BAT  file  or  in another batch file in a directory
  443.         typically called C:\NWCLIENT.  
  444.  
  445.              LSL
  446.              NE2000  }-- specific to your interface card
  447.              IPXODI
  448.              VLM
  449.  
  450.         The  packet driver shim (ODIPKT) logically sits on top of IPXODI,
  451.         providing  a  packet  driver  interface  for software such as KSP
  452.         SLIP: 
  453.  
  454.              LSL
  455.              NE2000 +--- Frame Type (0-3)
  456.              IPXODI |
  457.              ODIPKT 2 97  }--- The packet driver shim
  458.              VLM       |
  459.                        +----- Packet Vector Interrupt (96-127)
  460.                               (See comment below about hex vs. decimal)
  461.  
  462.  
  463.  
  464.  
  465.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  466.  
  467.  
  468.         Oct 03, 1996           KSP SLIP (tm) v3.7                       6
  469.  
  470.  
  471.         The  ODIPKT  command  line parameters may vary according to which
  472.         version  of  the  software  you  have  and  how  your hardware is
  473.         configured.   The "Frame Type" parameter should correspond to the
  474.         position  of  ETHERNET_II  among  the  frame  types  specified in
  475.         NET.CFG;  zero  (0)  selects  the  first  frame type, one (1) the
  476.         second,  and  so  on. The "Packet Vector Interrupt" number should
  477.         correspond  to  an  unused  interrupt  vector.   Note  that older
  478.         versions  of  ODIPKT  insist that this number be given in decimal
  479.         (96-127)  rather  than  in hex (0x60-0x7F).  The necessary packet
  480.         driver  shim can be downloaded from the Key Software Products BBS
  481.         as file ODI-SHIM.ZIP.   
  482.  
  483.  
  484.         2.2 Packet Driver Shim for Novell w/Token-RingSNAP    
  485.  
  486.         Another  shim  called  ODITRPKT  exists for Novell that should be
  487.         used  if the underlying network is Token-Ring_SNAP.  Installation
  488.         is  similar  to  ODIPKT as described above, except that the first
  489.         command  line  parameter  must  correspond to the Token-Ring_SNAP
  490.         frame  type  in NET.CFG, and starts at "1" rather than "0".  This
  491.         shim  can  be  downloaded  from  the Key Software Products BBS as
  492.         file TKN-SHIM.ZIP.  
  493.  
  494.  
  495.         2.3 Packet Driver Shims for Lantastic     
  496.  
  497.         Using   a   packet  driver  shim  with  Lantastic  requires  that
  498.         Lantastic  be  installed  using  NDIS  (Network  Driver Interface
  499.         Specification)  Support.  The necessary packet driver shim can be
  500.         downloaded   from   the   Key   Software  Products  BBS  as  file
  501.         DIS-SHIM.ZIP.  
  502.  
  503.         NDIS   allows  you  to  stack  multiple  protocols  on  a  single
  504.         adapter.   This  lets  you use multiple protocol drivers (such as
  505.         LANtastic  and  TCP/IP)  on  the  same adapter.  You can also use
  506.         NDIS  to  include  third-party adapters that have NDIS drivers in
  507.         your   LANtastic   network.    Supported  adapter  types  include
  508.         Ethernet,  Token-Ring  and ARCNET (R) adapters.  The software and
  509.         documentation  necessary  to  add  NDIS  support  to  an existing
  510.         Lantastic network is available free of charge from Artisoft.  
  511.  
  512.         Once  you  have NDIS installed and working with Lantastic, adding
  513.         the  shim is a simple matter of editing PROTOCOL.INI (part of the
  514.         NDIS support) and CONFIG.SYS.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  524.  
  525.  
  526.         Oct 03, 1996           KSP SLIP (tm) v3.7                       7
  527.  
  528.  
  529.         2.3.1 Changes to CONFIG.SYS       
  530.  
  531.         With  NDIS  installed,  there  will be two device driver lines in
  532.         your CONFIG.SYS file that look something like the following: 
  533.  
  534.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  535.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  536.  
  537.         The  file  listed  in  the  second line may differ if you are not
  538.         using  Artisoft's  interface  card; in that case, this file would
  539.         typically  be  replaced  by  a  NDIS  driver supplied by the card
  540.         manufacturer.  
  541.  
  542.         The  packet  driver  shim  itself  is installed as a third device
  543.         driver after the first two, as in: 
  544.  
  545.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  546.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  547.              DEVICE=C:\DRIVERS\DIS_PKT.DOS  }--- The packet driver shim
  548.  
  549.  
  550.         2.3.2 Changes to PROTOCOL.INI       
  551.  
  552.         The  PROTOCOL.INI  file  is  a  text file created (usually in the
  553.         C:\LANTASTI  directory) as part of the NDIS installation.  Before
  554.         adding  the  packet  driver  shim,  it  typically  looks like the
  555.         following,  but  with  the  "iobase"  and  "interrupt" parameters
  556.         changed   according   to   your  hardware,  or  with  the  entire
  557.         "[AEXNDIS_NIF]"   section  replaced  if  you  are  not  using  an
  558.         Artisoft interface card.  
  559.  
  560.              [PROTMAN]
  561.                DRIVERNAME = PROTMAN$
  562.                DYNAMIC = YES
  563.  
  564.              [AEXNDIS_NIF]
  565.                DRIVERNAME = AEXNDS$
  566.                IOBASE = 0x300
  567.                INTERRUPT = 15
  568.  
  569.         Adding  the packet driver shim requires adding another section to
  570.         the PROTOCOL.INI file: 
  571.  
  572.              [PROTMAN]
  573.                DRIVERNAME = PROTMAN$
  574.                DYNAMIC = YES
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  582.  
  583.  
  584.         Oct 03, 1996           KSP SLIP (tm) v3.7                       8
  585.  
  586.  
  587.              [AEXNDIS_NIF]               <---+
  588.                DRIVERNAME = AEXNDS$          |
  589.                IOBASE = 0x300                |
  590.                INTERRUPT = 15                | These names must match!
  591.                                              |
  592.              [PKTDRV]                        |
  593.                DRIVERNAME = PKTDRV$          |
  594.                BINDINGS = AEXNDIS_NIF    <---+
  595.                INTVEC = 0x61
  596.                CHAINVEC = 0x66
  597.                NOVELL = Y
  598.  
  599.         Note  that the name "AEXNDIS_NIF" must exactly match the spelling
  600.         used  as  the  title of the previous section, "[AEXNDIS_NIF]"; if
  601.         you  are not using Artisoft interface cards, then both occurences
  602.         will  use  some  other identifier.  The "INTVEC" parameter may be
  603.         anything  from  0x60  to 0x80; you may have to experiment to find
  604.         an unused interrupt number.  
  605.  
  606.  
  607.         2.4 Packet Driver Shims for Banyan Vines    
  608.  
  609.         Although  Key  Software  Products  has  never  used  it, and thus
  610.         cannot  offer help on its installation, a packet driver shim does
  611.         exist  for  Banyan  Vines  and  can  be  downloaded  from the Key
  612.         Software Products BBS as file BAN-SHIM.ZIP.  
  613.  
  614.  
  615.         2.5 Other Things to Configure      
  616.  
  617.         Once  your  network  is  up and running with a packet driver or a
  618.         packet driver shim, there are basically two additional steps: 
  619.  
  620.              1.  Create a WATTCP.CFG configuration file.  
  621.              2.  Configure KSP SLIP as a BBS door.  
  622.  
  623.         As  discussed  in the next chapter, you may not need a WATTCP.CFG
  624.         configuration file if you have a BOOTP server.  
  625.  
  626.         There  is  a  useful  program called TCPINFO available on the KSP
  627.         BBS.   If  you have no WATTCP.CFG file, it will tell you (after a
  628.         maximum  of 30 seconds) if it was able to automatically configure
  629.         itself  via  a  BOOTP  server.  If you have a WATTCP.CFG file, it
  630.         will  determine  whether  or  not  you  have configured that file
  631.         properly.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  640.  
  641.  
  642.         Oct 03, 1996           KSP SLIP (tm) v3.7                       9
  643.  
  644.  
  645.                  CHAPTER 3 - THE WATTCP CONFIGURATION FILE     
  646.  
  647.  
  648.         In  order  to  run, KSP SLIP needs to know some information about
  649.         your  network,  and  tries  to  find this in a configuration file
  650.         called  WATTCP.CFG.   KSP  SLIP  looks  in  three  directories to
  651.         locate  this  file.  First, it checks for an environment variable
  652.         called  WATTCP.CFG  that  specifies  the  directory.   Second, it
  653.         looks  in  the  current (default) directory.  Third, if still not
  654.         found,  it  looks  in  the directory that contains the executable
  655.         (KSP-SLIP.EXE).  
  656.  
  657.         The  following  example  may  be  helpful  for  those  using  the
  658.         environment  variable  approach:  If you place WATTCP.CFG in your
  659.         PCB  directory,  then  your  AUTOEXEC.BAT file should contain the
  660.         following command: 
  661.  
  662.                               set WATTCP.CFG=C:\PCB
  663.  
  664.           Note that there is no trailing "\" after the directory name!
  665.  
  666.         If  KSP  SLIP  still  can't  find the configuration file, it will
  667.         attempt  to  automatically  configure  itself  by  looking  for a
  668.         "BOOTP"  server  on  your network.  (BOOTP is a standard protocol
  669.         that  obtains  your "IP address" and other information about your
  670.         PC  from  a  BOOTP  server.)   If there is no BOOTP server, or if
  671.         your  PC  is not registered in its database, then you must create
  672.         a configuration file.  
  673.  
  674.         The  configuration  file  contains  one entry per line.  A sample
  675.         configuration  file  is  included  in  this distribution, but the
  676.         values  MUST  be  modified to suit your particular environment or
  677.         else KSP SLIP will not work!   
  678.  
  679.         The syntax of every entry follows the following format: 
  680.  
  681.            [ directive = [ "data" | data] ] [ # comment | ; comment ]
  682.  
  683.         I.e.,  if  a  directive is not followed by data, the directive is
  684.         ignored.   Similary,  lines  without directives are ignored.  The
  685.         directive is NOT case sensitive; the data IS case sensitive.   
  686.  
  687.         e.g.,   netmask=255.255.252.0
  688.                 domainslist=ksp.com    ; Our domain
  689.  
  690.         Whitespace  is normally removed from data; data containing blanks
  691.         must  be  surrounded by quotes.  An unquoted '#' or ';' marks the
  692.         beginning of a comment.  
  693.  
  694.  
  695.  
  696.  
  697.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  698.  
  699.  
  700.         Oct 03, 1996           KSP SLIP (tm) v3.7                      10
  701.  
  702.  
  703.  
  704.         3.1 Multiple Nodes and the "include" Directive    
  705.  
  706.         There  must  be  one WATTCP.CFG file for each BBS node since each
  707.         node  has  to  be  configured  with  a  unique  hostname  and  IP
  708.         address.   All  other configuration parameters are usually set at
  709.         the  same  values  for  all nodes.  Rather than duplicating these
  710.         common  entries  in each WATTCP.CFG file, you can set-up a master
  711.         configuration   file   that   gets  "included"  in  each  of  the
  712.         node-specific   files.    For  example,  the  node-specific  file
  713.         (WATTCP.CFG) might look like: 
  714.  
  715.                 include=c:\ksp\master.cfg
  716.                 hostname=ourbbspc
  717.                 myip=125.283.210.17
  718.  
  719.         This  makes it much easier to make changes since you only have to
  720.         modify a single file (MASTER.CFG).  
  721.  
  722.  
  723.         3.2 Using a BOOTP Server      
  724.  
  725.         It's  always  a good idea to have a configuration file whether or
  726.         not   you   use   a  BOOTP  server.   If  you  choose  to  use  a
  727.         configuration  file  and want to tell it to use the BOOTP server,
  728.         this  option  allows  you  to specify your the IP address of your
  729.         BOOTP server.  
  730.  
  731.  
  732.                 Example: bootp=129.255.0.128 
  733.  
  734.         You  should  specify the domain name manually as described in the
  735.         next  section  since  the  BOOTP  protocol  doesn't  provide that
  736.         information.  
  737.  
  738.                 Example: domainslist=ksp.com 
  739.  
  740.         NOTE:  An  "IP  address"  is  a logical addressing scheme used on
  741.         TCP/IP  networks  such  as the Internet.  Each computer connected
  742.         to  the  Internet  is  assigned  a unique IP address.  Your local
  743.         network  "guru"  or access provider should be able to provide you
  744.         with those IP addresses you need.   
  745.  
  746.         IMPORTANT:  The  IP  addresses  given  in  this document are only
  747.         examples.   Do  NOT  attempt to use them - they will NOT work and
  748.         your network administrator will probably get VERY upset! 
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  756.  
  757.  
  758.         Oct 03, 1996           KSP SLIP (tm) v3.7                      11
  759.  
  760.  
  761.         3.3 Manual Configuration        
  762.  
  763.         If  you  don't  have  a  BOOTP  server,  or  if  your  PC  is not
  764.         registered  with  a BOOTP server, then you must use the following
  765.         directives   to   configure   KSP  SLIP.   The  values  of  these
  766.         parameters   are  important,  and  KSP  SLIP  will  NOT  function
  767.         properly  without  the  proper  values.   If you are not familiar
  768.         with  the terminology, or if you are unsure of the proper values,
  769.         please consult with your network access provider.  
  770.  
  771.  
  772.         3.3.1 The PC's Host Name      
  773.  
  774.         This  is  the network name of the PC that runs your BBS (and thus
  775.         KSP  SLIP).   If  your  BBS  is implemented by a network of PC's,
  776.         then each PC should have its own unique host name.  
  777.  
  778.                 Example: hostname=bbs 
  779.  
  780.         Note  that  the  host  name  does  not  include  the  domain name
  781.         suffix.   For  example, the hostname of machine '"bbs.ksp.com" is
  782.         simply "bbs".  
  783.  
  784.  
  785.         3.3.2 The PC's Domain Name      
  786.  
  787.         This  is  the  network  name  of the subnet to which your PC (and
  788.         possibly others) are connected.  
  789.  
  790.                 Example: domainslist=ksp.com 
  791.  
  792.         Note  that  the  domain  name  does  not  include  the  host name
  793.         prefix.   For  example, the domain name of machine '"bbs.ksp.com"
  794.         is "ksp.com".  
  795.  
  796.  
  797.         3.3.3 The PC's IP Address      
  798.  
  799.         This is the unique IP address assigned to your PC.  
  800.  
  801.                 Example: my_ip=100.2.37.4  
  802.  
  803.         Your  local  network  "guru" or access provider should be able to
  804.         provide  you  with  the  proper IP address of your PC.  Note that
  805.         you  should  have  a  different  IP address for each node in your
  806.         BBS.  
  807.  
  808.         Note:  As  an  alternative, you may also set the IP address using
  809.         an environment variable, as in: 
  810.  
  811.  
  812.  
  813.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  814.  
  815.  
  816.         Oct 03, 1996           KSP SLIP (tm) v3.7                      12
  817.  
  818.  
  819.  
  820.                               set ksp-ip=100.2.37.4
  821.  
  822.  
  823.         3.3.4 The Name Server's IP Address     
  824.  
  825.         This  is  the  unique  IP  address  assigned  to  a  network name
  826.         nerver.   You  may  specify more than on nameserver by using more
  827.         than one "nameserver" line.  
  828.  
  829.                 Example: nameserver=111.21.108.110 
  830.  
  831.         Your  local  network  "guru" or access provider should be able to
  832.         provide  you  with the proper IP addresses of appropriate network
  833.         name servers.  
  834.  
  835.  
  836.         3.3.5 The Router's IP Address      
  837.  
  838.         This is the unique IP address assigned to the network router.  
  839.  
  840.           Syntax: gateway = ipaddr [ , subnet [ , subnet_mask ] ] 
  841.  
  842.                 Examples: gateway=129.97.176.1
  843.                           gateway=129.97.176.2, 129.97.0.0
  844.                           gateway=129.97.176.2, 129.97.0.0, 255.255.0.0
  845.  
  846.         Usually  the  (destination)  subnet  and  subnet mask need not be
  847.         specified,  and  is  used to create a "default".  The other forms
  848.         are  used  to  specify  one or more other gatewaya for particular
  849.         subnets.  
  850.  
  851.         Your  local  network  "guru" or access provider should be able to
  852.         provide you with the proper IP address of the network router.  
  853.  
  854.  
  855.         3.3.6 The PC's Network Mask      
  856.  
  857.         Network  masks  are  used to distinguish destination IP addresses
  858.         that  are  on  the  local  subnet  from those that are not.  This
  859.         option may not be required, depending on your network topology.  
  860.  
  861.                 Example: netmask=255.255.254.0 
  862.  
  863.         Your  local  network  "guru" or access provider should be able to
  864.         provide you with the proper netmask if needed.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  872.  
  873.  
  874.         Oct 03, 1996           KSP SLIP (tm) v3.7                      13
  875.  
  876.  
  877.         3.4 TCP/IP Parameters (optional)       
  878.  
  879.         KSP  SLIP  will  work without using the following parameters, but
  880.         they are provided if you wish to change them.  
  881.  
  882.  
  883.         3.4.1 Timeouts         
  884.  
  885.         Most  network  operations (such as establishing a connection to a
  886.         remote  host)  have a maximum time before a timeout error occurs.
  887.         The  default  value is 30 seconds; a smaller value is unwise, but
  888.         larger   values   may   be   necessary   for   particularly   bad
  889.         connections.  
  890.  
  891.                 Example: sockdelay=40 
  892.  
  893.  
  894.         3.4.2 Maximum Segment Size (MSS)      
  895.  
  896.         The  default  value  of  MSS  is  1400.  If you know what maximum
  897.         segment  size  means  and know what size you want, you can change
  898.         it: 
  899.  
  900.                 Example: mss=512 
  901.  
  902.                 Note:  Some  Internet  access  providers  configure their
  903.                 dial-up  slip  and ppp accounts with a very small segment
  904.                 size.   You  may  need  to  set mss as low as 212 if your
  905.                 Internet connection is through such a connection.  
  906.  
  907.  
  908.         3.5 SLIP Operating Parameters       
  909.  
  910.         The  remaining  parameters in WATTCP.CFG are operating parameters
  911.         for  KSP  SLIP  that define limits and display files needed while
  912.         KSP SLIP is running.  Each follows the format: 
  913.  
  914.                 ksp-slip.<parameter>=<value> 
  915.  
  916.         where   <parameter>  and  <value>  are  replaced  by  appropriate
  917.         strings.  
  918.  
  919.         Some  operating  parameters have counterparts in other members of
  920.         the  KSP  family  of  network  application programs.  Rather than
  921.         have   multiple   entries   in   the  WATTCP.CFG  file  for  each
  922.         application,  such parameters can be specified globally using the
  923.         format: 
  924.  
  925.                 ksp.<parameter>=<value> 
  926.  
  927.  
  928.  
  929.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  930.  
  931.  
  932.         Oct 03, 1996           KSP SLIP (tm) v3.7                      14
  933.  
  934.  
  935.  
  936.         This  global setting can be overridden for a specific application
  937.         by  using  the  application-specific form at a subsequent line in
  938.         WATTCP.CFG.  
  939.  
  940.  
  941.         3.5.1 Dynamic Parameters        
  942.  
  943.         Configuration  file  parameters  can  be  made  "dynamic".   Such
  944.         parameters  are ignored unless activated by an associated command
  945.         line option: 
  946.  
  947.                 /CONFIG=<number> 
  948.  
  949.         where  "<number>"  is  a non-zero integer.  Dynamic configuration
  950.         parameters  are  those that specify a number in square backets as
  951.         in: 
  952.  
  953.                 ksp-slip[<number>].<parameter>=<value> 
  954.  
  955.         The  number  specified  in the configuration parameter must match
  956.         that  in  the  command  line  option  or  else  the configuration
  957.         parameter will be ignored.  
  958.  
  959.         This also works for dynamic global parameters of the form: 
  960.  
  961.                 ksp[<number>].<parameter>=<value> 
  962.  
  963.  
  964.         3.5.2 Blocking Access to Certain Sites     
  965.  
  966.          Syntax: ksp-slip.blocked_tcp=<blocked>[,<address_mask>[,<forward>]]
  967.              or: ksp-slip.blocked_udp=<blocked>[,<address_mask>[,<forward>]]
  968.  
  969.           Where: <blocked> and <forward> are each of the form
  970.  
  971.                  <dotted_ip_address>[:<port_number>]
  972.  
  973.         Example: (see below) 
  974.  
  975.         Purpose: Specifies  a  blocked  TCP (or UDP) site and mask, and a
  976.                  new  forwarding  site;  each  site is specified as an IP
  977.                  address  and  optional  port number.  May be repeated to
  978.                  block  additional  sites.   No  access to sites matching
  979.                  one    of    these    specs   will   be   allowed   (see
  980.                  "ksp-slip.allowed_tcp""   and   "ksp-slip.allowed_udp"),
  981.                  although  such  access  may  be  optionally forwarded to
  982.                  another site.  
  983.  
  984.  
  985.  
  986.  
  987.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  988.  
  989.  
  990.         Oct 03, 1996           KSP SLIP (tm) v3.7                      15
  991.  
  992.  
  993.                  Any  value may be omitted; commas are sometimes required
  994.                  when   then   default   mask  is  implied  by  omission.
  995.                  Defaults are as follows: 
  996.  
  997.                  <blocked> = <blocked_IP>:<blocked_port>
  998.                  <forward> = <forward_IP>:<forward_port>
  999.  
  1000.                  <blocked_IP>   = 0.0.0.0 (not legal)
  1001.                  <blocked_port> = 0 (match any port number)
  1002.                  <address_mask> = 255.255.255.255
  1003.                                    (match ALL bits of <blocked_IP>)
  1004.  
  1005.                  <forward_IP>   = 0.0.0.0 (don't forward this packet)
  1006.                  <forward_port> = 0 (use original destination port)
  1007.  
  1008.                  A  match  occurs  when  the  site's  IP  address and the
  1009.                  <blocked_IP>  address  of  an  entry in the file are the
  1010.                  same   everywhere   there   are   1's   in   the  binary
  1011.                  representation   of   <address_mask>;  the  site's  port
  1012.                  number  must  match <blocked_port> only if the latter is
  1013.                  non-zero.   Matching  occurs  in  the  same  order  that
  1014.                  entries  appear  in  the  WATTCP.CFG configuration file;
  1015.                  when  a  original  IP  address  and  port match multiple
  1016.                  entries, the first match found is the one that's used.  
  1017.  
  1018.                  Consider the following examples: 
  1019.  
  1020.                  1.2.3.4                         No access to this IP
  1021.                                                  address.
  1022.  
  1023.                  1.2.3.4:21                      No access to port 21
  1024.                                                  at this IP.
  1025.  
  1026.                  1.2.3.4,,5.6.7.8:21             All packets addressed 
  1027.                                                  to 1.2.3.4 are forwarded
  1028.                                                  to 5.6.7.8, port 21
  1029.  
  1030.                  1.2.3.0,255.255.255.0           No access to 1.2.3.0
  1031.                                                  through 1.2.3.255
  1032.  
  1033.                  1.2.3.0:21,255.255.255.0        Same as last, but 
  1034.                                                  only port 21.
  1035.  
  1036.         Comment: If  no forwarding address is specified, KSP-SLIP returns
  1037.                  a  type  3 ("host unreachable") ICMP error packet to the
  1038.                  caller's  slip client software, with explanation code 10
  1039.                  ("communication     with     destination     host     is
  1040.                  administratively  forbidden").   Although  the  caller's
  1041.                  client   software  may  present  a  corresponding  error
  1042.  
  1043.  
  1044.  
  1045.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1046.  
  1047.  
  1048.         Oct 03, 1996           KSP SLIP (tm) v3.7                      16
  1049.  
  1050.  
  1051.                  message  to  the  user,  some  (such as Trumpet Winsock)
  1052.                  will  simply  ignore  such  ICMP packets.  In the latter
  1053.                  case,  the  user  may  not  understand  why  there's  no
  1054.                  response   from   the   remote   host,   and  thus  some
  1055.                  explanation  (such  as  a  posted  bulletin)  should  be
  1056.                  provided on the BBS.  
  1057.  
  1058.         Comment: Nameservers  use UDP port 53 translate domain names into
  1059.                  IP   addresses.    The   nameservers   listed   in  your
  1060.                  WATTCP.CFG   file   are   automatically   considered  as
  1061.                  exceptions    (see   below)   to   your   UDP   blocking
  1062.                  restrictions;   there   is   no  need  to  specify  such
  1063.                  exceptions   explicitly.   You  may  wish  to  consider,
  1064.                  however,  specifying  an  general  exception for all UDP
  1065.                  port  53  access  regardless  of  IP address in case the
  1066.                  remote  SLIP  user has configured a different nameserver
  1067.                  in their setup.  
  1068.  
  1069.         Comment: If  <forward>  is  specified  as 0.0.0.x where 0 < "x" <
  1070.                  256,  then  rather than forwarding the blocked packet to
  1071.                  this  IP  address, KSP-SLIP will exit with an errorlevel
  1072.                  of "x".  
  1073.  
  1074.  
  1075.         3.5.3 Exceptions to Blocking       
  1076.  
  1077.          Syntax: ksp-slip.allowed_tcp=<destination>[,<address_mask>] 
  1078.              or: ksp-slip.allowed_udp=<destination>[,<address_mask>] 
  1079.  
  1080.           Where: <destination> = <dotted_ip_address>[:<port_number>] 
  1081.  
  1082.         Example: (see examples for "ksp-slip.blocked_tcp") 
  1083.  
  1084.         Purpose: Specifies  an  exception  to  the  TCP  or  UDP blocking
  1085.                  restrictions.   May  be  repeated  as  necessary to list
  1086.                  more   than  one  exception.   Note  that  there  is  no
  1087.                  "<forward>"   parameter.    These  parameters  are  only
  1088.                  useful in combination with blocking parameters.  
  1089.  
  1090.  
  1091.         3.5.4 Combining Blocking + Forwarding + Exceptions    
  1092.  
  1093.         The  following combination causes all telnet and ftp access to be
  1094.         redirected  to  129.20.31.12  and  all  http  (Web)  access to be
  1095.         redirected  to  210.200.54.2.  Any other TCP access is redirected
  1096.         to  200.73.49.32; the last entry, however, specifies an exception
  1097.         to  these  rules  and  allows  any  kind  of  access  to machines
  1098.         137.40.15.0 through 137.40.15.255 
  1099.  
  1100.  
  1101.  
  1102.  
  1103.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1104.  
  1105.  
  1106.         Oct 03, 1996           KSP SLIP (tm) v3.7                      17
  1107.  
  1108.  
  1109.            ksp-slip.blocked_tcp=0.0.0.0:23,0.0.0.0,129.20.31.12 ; telnet
  1110.            ksp-slip.blocked_tcp=0.0.0.0:21,0.0.0.0,129.20.31.12 ; ftp
  1111.            ksp-slip.blocked_tcp=0.0.0.0:80,0.0.0.0,210.200.54.2:81 ; http
  1112.            ksp-slip.blocked_tcp=0.0.0.0,0.0.0.0,0,200.73.49.32 ; default
  1113.            ksp-slip.allowed_tcp=137.40.15.0,255.255.255.0,0
  1114.  
  1115.         Note  that  the  mask  is 0.0.0.0 in each of the first four lines
  1116.         causes  all  of the IP address bits to be ignored; i.e., that the
  1117.         IP  address  is  a  "don't  care".  The fifth line uses a mask of
  1118.         255.255.255.0;  this  requires  only  the first 24 bits of the IP
  1119.         address to match (corresponding to a class C subnet).  
  1120.  
  1121.         These  entries have no effect on ARP or UDP protocol access; thus
  1122.         there  is  no  need  to  include  an "allowed_tcp" entry for your
  1123.         router(s) (gateways) or name server(s).  
  1124.  
  1125.  
  1126.         3.5.5 Session Time Limit       
  1127.  
  1128.          Syntax: ksp-slip.max_mins=<number> 
  1129.  
  1130.         Example: ksp-slip.max_mins=30 
  1131.  
  1132.         Purpose: Overrides  the  time  remaining as specified in DOOR.SYS
  1133.                  if  lower.  If omitted, time remaining is that specified
  1134.                  by DOOR.SYS.  
  1135.  
  1136.  
  1137.         3.5.6 Session Reserve Time       
  1138.  
  1139.          Syntax: ksp-slip.reserve_mins=<number> 
  1140.  
  1141.         Example: ksp-slip.reserve_mins=3 
  1142.  
  1143.         Purpose: Reduces  the  time available in the door so that if time
  1144.                  runs  out,  the  user  still  has a small amount of time
  1145.                  left  on  the BBS.  This is useful, for example, if your
  1146.                  BBS  offers  a  Time  Bank  so  that users can use it to
  1147.                  withdraw extra time.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1162.  
  1163.  
  1164.         Oct 03, 1996           KSP SLIP (tm) v3.7                      18
  1165.  
  1166.  
  1167.         3.5.7 Inactivity Limit        
  1168.  
  1169.          Syntax: ksp-slip.idle_mins=<minutes> 
  1170.  
  1171.         Example: ksp-slip.idle_mins=10 
  1172.  
  1173.         Purpose: Establishes  an  upper limit on how long the session can
  1174.                  remain  inactive  before  it is terminated.  If omitted,
  1175.                  no inactivity limit is imposed.  
  1176.  
  1177.  
  1178.         3.5.8 Minimum Baud Rate       
  1179.  
  1180.          Syntax: ksp-slip.minbaud=<baudrate>[,<security>] 
  1181.  
  1182.         Example: ksp-slip.minbaud=9600 
  1183.  
  1184.         Example: ksp-slip.minbaud=9600,100 
  1185.  
  1186.         Purpose: Specifies  a  minimum  baud  rate  required  to  use the
  1187.                  gateway,  and  an  optional  security  level required to
  1188.                  override  the minimum baud rate.  If omitted, no minimum
  1189.                  baud rate will be required.  
  1190.  
  1191.  
  1192.         3.5.9 Operating Hours        
  1193.  
  1194.          Syntax: ksp-slip.ophours=<hh:mm-hh:mm> 
  1195.  
  1196.         Example: ksp-slip.ophours=21:00-23:00 
  1197.  
  1198.         Purpose: To  establish  the  hours  of operation for the gateway;
  1199.                  attempts  to  use  the  gateway  at  other times will be
  1200.                  disallowed.    Times   must  be  specified  in  24  hour
  1201.                  format.   If  omitted,  the  gateway  may be used at any
  1202.                  time.  
  1203.  
  1204.         Note: If  start  time  is  after  the  stop  time,  the  hours of
  1205.               operation  will  be  interpreted  as  all  but those in the
  1206.               window  specified.   I.e.,  setting  ophours to 03:20-03:00
  1207.               will allow operation anytime except 03:00-03:20.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1220.  
  1221.  
  1222.         Oct 03, 1996           KSP SLIP (tm) v3.7                      19
  1223.  
  1224.  
  1225.         3.5.10 Startup Message        
  1226.  
  1227.          Syntax: ksp-slip.startup_msg=<filespec> 
  1228.  
  1229.         Example: ksp-slip.startup_msg=c:\ksp-slip\startup.msg 
  1230.  
  1231.         Purpose: Specifies  the  location  of  a display file sent to the
  1232.                  user  when  the  gateway is initialized.  If omitted, no
  1233.                  display file is sent.  
  1234.  
  1235.  
  1236.         3.5.11 Minimum Baud Rate Message      
  1237.  
  1238.          Syntax: ksp-slip.minbaud_msg=<filespec> 
  1239.  
  1240.         Example: ksp-slip.minbaud_msg=c:\ksp-slip\minbaud.msg 
  1241.  
  1242.         Purpose: Specifies  the  location  of  a display file sent to the
  1243.                  user  if the his baud rate is less than that required by
  1244.                  the  "ksp-slip.minbaud"  option (described earlier).  If
  1245.                  omitted, no display file is sent.  
  1246.  
  1247.  
  1248.         3.5.12 Operating Hours Message       
  1249.  
  1250.          Syntax: ksp-slip.ophours_msg=<filespec> 
  1251.  
  1252.         Example: ksp-slip.ophours_msg=c:\ksp-slip\ophours.msg 
  1253.  
  1254.         Purpose: Specifies  the  location  of  a display file sent to the
  1255.                  user  if  the  he  attempts  to use the gateway at other
  1256.                  than  the  hours  specified  by  the  "ksp-slip.ophours"
  1257.                  option  (described  earlier).   If  omitted,  no display
  1258.                  file is sent.  
  1259.  
  1260.  
  1261.         3.5.13 User Session Logging       
  1262.  
  1263.          Syntax: ksp-slip.log_dir=<pathspec> 
  1264.  
  1265.         Example: ksp-slip.log_dir=c:\ksp-slip 
  1266.  
  1267.         Purpose: Specifies  the  name  of a directory where a log of user
  1268.                  sessions   will  be  kept.   The  log  files  are  named
  1269.                  KSP-SLIP.???, where "???" is the BBS node number.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1278.  
  1279.  
  1280.         Oct 03, 1996           KSP SLIP (tm) v3.7                      20
  1281.  
  1282.  
  1283.         3.5.14 SLIP Packet Monitor       
  1284.  
  1285.          Syntax: ksp-slip.status=<method> 
  1286.  
  1287.         Example: ksp-slip.status=direct 
  1288.  
  1289.         Purpose: Enables  local console display of SLIP packet counts and
  1290.                  selects  output method.  Options are "direct" (fastest),
  1291.                  "bios",  and  "ansi"  (slowest).   If  running  under  a
  1292.                  multi-tasker,  you may need to specify "ansi" or "bios";
  1293.                  otherwise use "direct".  
  1294.  
  1295.  
  1296.         3.5.15 Non-Standard Port/Fossil Break Detect      
  1297.  
  1298.          Syntax: ksp-slip.serial_port=<adr>,<irq> 
  1299.  
  1300.         Example: ksp-slip.serial_port=3F8,5 
  1301.  
  1302.         Purpose: Used  to  override serial port and IRQ values implied by
  1303.                  "COMx"    in    DOOR.SYS    to    support   non-standard
  1304.                  configurations  that  are  NOT  using  a  fossil driver.
  1305.                  Also  used  WITH  a  fossil  driver  to add serial break
  1306.                  detection  as  required to return to BBS without hanging
  1307.                  up.  
  1308.  
  1309.                  The  port  address  <adr>  must be specified in hex, and
  1310.                  the   interrupt   request  line  number  <irq>  must  be
  1311.                  specified in decimal.  
  1312.  
  1313.  
  1314.         3.5.16 Eliminating the Startup Count-Down      
  1315.  
  1316.          Syntax: ksp-slip.countdown=<yes|no> 
  1317.  
  1318.         Example: ksp-slip.countdown=no 
  1319.  
  1320.         Purpose: Used  to  eliminate the default "Press any key to begin"
  1321.                  message  and  nine-second countdown at startup.  Default
  1322.                  is 'yes'.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1336.  
  1337.  
  1338.         Oct 03, 1996           KSP SLIP (tm) v3.7                      21
  1339.  
  1340.  
  1341.         3.5.17 Silencing the BBS console bell     
  1342.  
  1343.          Syntax: ksp-slip.local_bell=<option> 
  1344.  
  1345.         Example: ksp-slip.local_bell=disabled 
  1346.  
  1347.         Purpose: Used to silence the bell on the local BBS console.  
  1348.  
  1349.  
  1350.         3.5.18 Disabling the Local Screen      
  1351.  
  1352.          Syntax: ksp-slip.local_screen=<option> 
  1353.  
  1354.         Example: ksp-slip.local_screen=disabled 
  1355.  
  1356.         Purpose: Used  to  disable  painting  of  the local (BBS) screen,
  1357.                  thus  improving  screen  painting  speed for the caller.
  1358.                  This  option  does  not  affect  status  displays on the
  1359.                  local console.  
  1360.  
  1361.  
  1362.         3.5.19 Hanging Up When Exiting From the Door   
  1363.  
  1364.          Syntax: ksp-slip.hangup=<option> 
  1365.  
  1366.         Example: ksp-slip.hangup=disabled 
  1367.  
  1368.         Purpose: KSP-SLIP  will hangup before returning to the BBS if the
  1369.                  session   was   terminated   due   to  expired  time  or
  1370.                  inactivity.    This   protects   the  BBS  command  line
  1371.                  interpreter  from  being  fed  the  remnants of a tcp/ip
  1372.                  packet.   However, this parameter can be used to prevent
  1373.                  this hangup by setting it to "disabled".  
  1374.  
  1375.                  Comment: Optional; default is "enabled".  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1394.  
  1395.  
  1396.         Oct 03, 1996           KSP SLIP (tm) v3.7                      22
  1397.  
  1398.  
  1399.                 CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND    
  1400.  
  1401.  
  1402.         Install  KSP  SLIP  as  you  would any other door program on your
  1403.         BBS.   Be  sure  you  setup the BBS to create a DOOR.SYS file for
  1404.         KSP  SLIP  when  it  runs.   (KSP  SLIP  does not need a USER.SYS
  1405.         file.)   If you are running multiple BBS nodes accessing a single
  1406.         copy  of  the  file  KSP-SLIP.EXE, then don't forget to make that
  1407.         file  (and  the  *.MSG  display  files)  read-only  using the DOS
  1408.         ATTRIB command in order to avoid sharing conflicts.  
  1409.  
  1410.         Most  BBS's  use  a  batch  file  to run a door.  For example, on
  1411.         PCBoard  systems you might create a door batch file called "SLIP"
  1412.         containing simply: 
  1413.  
  1414.                 C:\KSP\KSP-SLIP 
  1415.                 BOARD 
  1416.  
  1417.         Do  NOT  change  directories  within  this  batch file!  KSP SLIP
  1418.         expects  to  find  the  DOOR.SYS  file in whatever is the default
  1419.         directory  at  the  moment it starts to run.  That's why the name
  1420.         of  the  program  is preceeded by the name of the directory where
  1421.         it is located.  
  1422.  
  1423.         Of  course, you must also configure your BBS so it knows where to
  1424.         find this batch file (SLIP).  
  1425.  
  1426.  
  1427.         4.1 Command Line Parameters       
  1428.  
  1429.         4.1.1 The /MAXMINS Parameter       
  1430.  
  1431.         The  /MAXMINS  parameter  is an alternative to the same parameter
  1432.         that  appears  in  the  WATTCP.CFG  file.   It  provides  another
  1433.         mechanism  for  limiting  the maximum time a caller is allowed in
  1434.         the door.  The syntax is: 
  1435.  
  1436.                 /MAX_MINS=<minutes> 
  1437.  
  1438.         where "<minutes>" is replaced by a number, as in: 
  1439.  
  1440.                 KSP-SLIP /MAX_MINS=60 
  1441.  
  1442.  
  1443.         4.1.2 The /CONFIG Parameter       
  1444.  
  1445.         The  /CONFIG  parameter  is  used  in  conjunction with "dynamic"
  1446.         configuration  parameters  to  enable  or  disable  them.   For a
  1447.         complete  description  of  this  feature,  please see the section
  1448.  
  1449.  
  1450.  
  1451.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1452.  
  1453.  
  1454.         Oct 03, 1996           KSP SLIP (tm) v3.7                      23
  1455.  
  1456.  
  1457.         called "Dynamic Parameters".  
  1458.  
  1459.  
  1460.         4.1.3 KSP-SLIP.EXE Exit Codes       
  1461.  
  1462.         At  the  end of execution, KSP-SLIP exits with an errorlevel that
  1463.         indicates the reason for termination: 
  1464.  
  1465.                 0       User never got past startup screen 
  1466.                 1       Carrier lost (user hung up) 
  1467.                 2       Break detected (intentionally sent by user) 
  1468.                 3       Inactivity timeout 
  1469.                 4       Session timeout 
  1470.                 255     Some sort of program error condition 
  1471.  
  1472.  
  1473.         4.1.4 Checking Packet Counts (PKTCOUNT.EXE)      
  1474.  
  1475.         At  the  end  of execution, KSP-SLIP writes a one-line ascii text
  1476.         file  containing three numbers.  For example, the line might look
  1477.         like: 
  1478.  
  1479.         1534  1647 35
  1480.           |     |   |
  1481.           |     |   +--- number of bad packets received from user
  1482.           |     +------- number of good packets received from user
  1483.           +------------- number of packets transmitted to user
  1484.  
  1485.         The  content  of  this  file  is  overwritten  each  time you run
  1486.         KSP-SLIP.   A  companion  program  called  PKTCOUNT.EXE  has been
  1487.         provided  to  read  and  exits  with  one of these numbers as its
  1488.         errorlevel  (limited  to  255);  this  program can be used in the
  1489.         batch  file  that  runs the door for various accounting purposes.
  1490.         For  example,  you  may  not  wish  to charge a user if they were
  1491.         having  configuration  problems  with their slip client software,
  1492.         usually  indicated by lots of bad packets received and only a few
  1493.         good ones.  
  1494.  
  1495.         The PKTCOUNT program requires one command line argument: 
  1496.  
  1497.                 PKTCOUNT <option>
  1498.  
  1499.         where  "<option>"  is  one  of "SENT", "GOOD", or "BAD".  Running
  1500.         the  program  with  no command line argument will produce a short
  1501.         usage summary.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1510.  
  1511.  
  1512.         Oct 03, 1996           KSP SLIP (tm) v3.7                      24
  1513.  
  1514.  
  1515.                    CHAPTER 5 - INSTALLING YOUR ACCESS KEY     
  1516.  
  1517.  
  1518.         The  unlicensed version of KSP SLIP limits each user to a maximum
  1519.         of  five  minutes  per  session.   To remove this limit, you must
  1520.         purchase  an  access  key and install it as described below; once
  1521.         installed,  users will be limited only by their time remaining on
  1522.         the BBS.  
  1523.  
  1524.         There  are  three  parameters  that  must  be  specified  in  two
  1525.         environment  variables called "KSP-ID" and "KSP-SLIP" in order to
  1526.         install  your access key; the access key will not be validated if
  1527.         any parameter is missing.  
  1528.  
  1529.         The  environment  variable  "KSP-ID"  is used to specify your BBS
  1530.         name, as in: 
  1531.  
  1532.                       set ksp-id=Key Software Products BBS
  1533.  
  1534.         The  environment  variable  "KSP-SLIP"  is  used  to  specify the
  1535.         number  of BBS nodes and your access key separated by a semicolon
  1536.         as in: 
  1537.  
  1538.                              set ksp-slip=2;12345678
  1539.  
  1540.         The  access  key  is  derived  from  the name of your BBS and the
  1541.         number   of   BBS  nodes.   The  specified  key  must  match  the
  1542.         combination  of BBS name and nodes.  If not, or if you invoke KSP
  1543.         SLIP  on a node whose node number is greater than indicated, then
  1544.         the caller will be limited to five minutes per session.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1568.  
  1569.  
  1570.         Oct 03, 1996           KSP SLIP (tm) v3.7                      25
  1571.  
  1572.  
  1573.                  CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES     
  1574.  
  1575.  
  1576.         The distribution package includes three sample display files: 
  1577.  
  1578.            OPHOURS.MSG     Displayed during off hours
  1579.            STARTUP.MSG     Displayed on start of gateway session
  1580.            LOSPEED.MSG     Displayed if baud rate is too low
  1581.  
  1582.         These   files   have  been  customized  by  the  use  of  certain
  1583.         predefined  "macros".  Some of these macros are a subset of those
  1584.         supported by PCBoard, while others are unique to KSP SLIP.  
  1585.  
  1586.  
  1587.         6.1 PCBoard Display Macros       
  1588.  
  1589.         The  following  PCBoard  display  macros,  plus  all of PCBoard's
  1590.         "@X##"  color control macros, may be used within KSP SLIP display
  1591.         files.   For  a  description of what they represent, refer to the
  1592.         PCBoard documentation.  
  1593.  
  1594.                     @BEEP@          @CLREOL@        @CLS@
  1595.                     @FIRST@         @MINLEFT@       @SECURITY@
  1596.                     @SYSDATE@       @SYSTIME@       @USER@
  1597.                     @POS:#@
  1598.  
  1599.  
  1600.         6.2 Macros Unique to KSP SLIP     
  1601.  
  1602.         The  following  additional display file macros are also supported
  1603.         by KSP SLIP.  
  1604.  
  1605.                 @SLIPIP@                The IP address of the BBS node
  1606.                 @SLIPNAME@              The SLIP node's network name
  1607.                 @DCESPEED@              Current DCE (carrier) speed
  1608.                 @DTESPEED@              Current DTE (PC-Modem) speed
  1609.                 @EXPIRETIME@            Expire time in HH:MM format
  1610.                 @IDLEMINS@              Maximum inactivity time
  1611.                 @MINDCESPEED@           Minimum DCE (carrier) speed
  1612.                 @OPHOURS@               Hours of operation
  1613.                 @OVERRIDE@              Override security for mindcespeed
  1614.  
  1615.  
  1616.         6.3 Justification and Spacing       
  1617.  
  1618.         Any  of  the text insertion macros used in KSP SLIP display files
  1619.         can  appear  in  one  of four forms as discussed in the following
  1620.         paragraphs.    These  options  allow  you  to  precisely  control
  1621.         spacing,  and  allow  you  to  draw a box around a message - even
  1622.  
  1623.  
  1624.  
  1625.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1626.  
  1627.  
  1628.         Oct 03, 1996           KSP SLIP (tm) v3.7                      26
  1629.  
  1630.  
  1631.         when replacement text within a line has a varying length.  
  1632.  
  1633.  
  1634.         6.3.1 No Justification        
  1635.  
  1636.          Syntax: @<keyword>@ 
  1637.  
  1638.         Example: @USER@ 
  1639.  
  1640.         Purpose: Inserts  the  replacment  text, using as many columns as
  1641.                  are necessary.  
  1642.  
  1643.  
  1644.         6.3.2 Left Justification        
  1645.  
  1646.          Syntax: @<keyword>:<number>@ 
  1647.              or: @<keyword>:<number>L@ 
  1648.  
  1649.         Example: @USER:15@ 
  1650.              or: @USER:15L@ 
  1651.  
  1652.         Purpose: Insert  the  replacement text, left justifying it within
  1653.                  a   field   whose  width  is  specified  by  the  number
  1654.                  following  the colon.  If more columns are required than
  1655.                  provided  in  the  field  width,  the field is expanded.
  1656.                  macro.  
  1657.  
  1658.  
  1659.         6.3.3 Center Justification        
  1660.  
  1661.          Syntax: @<keyword>:<number>C@ 
  1662.  
  1663.         Example: @USER:15C@ 
  1664.  
  1665.         Purpose: Insert  the  replacement  text,  centering  it  within a
  1666.                  field  whose  width is specified by the number following
  1667.                  the  colon.   If more columns are required than provided
  1668.                  in the field width, the field is expanded.  
  1669.  
  1670.  
  1671.         6.3.4 Right Justification        
  1672.  
  1673.          Syntax: @<keyword>:<number>R@ 
  1674.  
  1675.         Example: @USER:15R@ 
  1676.  
  1677.         Purpose: Insert  the replacement text, right justifying it within
  1678.                  a   field   whose  width  is  specified  by  the  number
  1679.                  following  the colon.  If more columns are required than
  1680.  
  1681.  
  1682.  
  1683.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1684.  
  1685.  
  1686.         Oct 03, 1996           KSP SLIP (tm) v3.7                      27
  1687.  
  1688.  
  1689.                  provided in the field width, the field is expanded.  
  1690.  
  1691.  
  1692.         6.4 The DISPLAY Program       
  1693.  
  1694.         Included  among  the distribution files is DISPLAY.EXE, a program
  1695.         that  helps  design  a  display  file by allowing it to be viewed
  1696.         offline.  The command line syntax is: 
  1697.  
  1698.                           DISPLAY [-g] [-7] <filespec>
  1699.  
  1700.         Where:  <filespec>   Is the name of the display file.
  1701.                              The filename extension defaults
  1702.                              to ".MSG" if omitted.
  1703.  
  1704.                 []           Denotes an optional argument.
  1705.  
  1706.                 -g           Enables (color) graphics and
  1707.                              ANSI control sequences; requires
  1708.                              ANSI.SYS to be installed.
  1709.                              Default is disabled.
  1710.  
  1711.                 -7           Replaces 8-bit graphics characters
  1712.                              with suitable 7-bit alternatives.
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1742.  
  1743.  
  1744.         Oct 03, 1996           KSP SLIP (tm) v3.7                      28
  1745.  
  1746.  
  1747.                         APPENDIX 1 - HOW TO REACH US     
  1748.  
  1749.  
  1750.         The  Key Software Products BBS/FAX number (415-364-9847) operates
  1751.         24   hours   a   day,  7  days  a  week.   Software  at  our  end
  1752.         automatically  determines whether an incoming call is data or FAX
  1753.         and will operate accordingly.  
  1754.  
  1755.         If  you have access to electronic mail, you can send us a message
  1756.         via any of the following: 
  1757.  
  1758.         On COMPUSERVE, send mail to:
  1759.  
  1760.                 >Internet:tech.support@ksp.com
  1761.  
  1762.         On Internet, UUCP, or Bitnet, send mail to:
  1763.  
  1764.                 tech.support@ksp.com
  1765.  
  1766.         On Fidonet, address mail to "UUCP" at nearest fidonet site which
  1767.         provides a gateway to Internet, such as 1:105/42.
  1768.  
  1769.                 1st line of message: To: tech.support@ksp.com
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1800.  
  1801.  
  1802.         Oct 03, 1996           KSP SLIP (tm) v3.7                      29
  1803.  
  1804.  
  1805.                 APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    
  1806.  
  1807.  
  1808.         The  main  distribution  file  is KSPSLP??.ZIP, where "??" is the
  1809.         version  number.   You  can retrieve this file via modem from our
  1810.         BBS  or  via  anonymous ftp at "scizzl.scu.edu", directory "ksp".
  1811.         Please note that there is no "e" at the end of "scizzl".  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1858.  
  1859.  
  1860.         Oct 03, 1996           KSP SLIP (tm) v3.7                      30
  1861.  
  1862.  
  1863.                          APPENDIX 3 - LEGAL STUFF       
  1864.  
  1865.  
  1866.                                 LIMITED WARRANTY
  1867.  
  1868.         This  software  is provided 'as is' without warranty of any kind,
  1869.         either  expressed  or  implied, including, but not limited to the
  1870.         implied   warranties   of   merchantability  and  fitness  for  a
  1871.         particular  purpose.   The  entire  risk  as  to  the quality and
  1872.         performance of the program is with you.  
  1873.  
  1874.         Some  states do not allow the exclusion of implied warranties, so
  1875.         the  above  exclusions may not apply to you.  This warranty gives
  1876.         you  specific  legal  rights  and  you may also have other rights
  1877.         which vary from state to state.  
  1878.  
  1879.         Key  Software  Products  has  taken  due  care  in  preparing the
  1880.         documentation  and  software  included  in   to  ascertain  their
  1881.         correctness  and  effectiveness.   However, Key Software Products
  1882.         does  not  warrant  that  operation  of  this  software  will  be
  1883.         uninterrupted  or  error  free.   In  no event shall Key Software
  1884.         Products  be  liable  for  incidental or consequential damages in
  1885.         connection  with  or  arising out of the furnishing, performance,
  1886.         or use of this software.  
  1887.  
  1888.  
  1889.                                      LICENSE
  1890.  
  1891.         You  MAY  use  this software on any computer or computers in your
  1892.         possession.   The licensed version is registered for use on up to
  1893.         a  fixed  number of BBS nodes running on multiple machines and/or
  1894.         multiple multi-tasking processes.  
  1895.  
  1896.         You  MAY  copy this software into any machine readable or printed
  1897.         form  for  backup or modification purposes in support of your use
  1898.         of the software.  
  1899.  
  1900.         You  MAY  distribute  the original unmodified, unlicensed version
  1901.         of  this  software,  but you may not charge a fee exceeding $5.00
  1902.         to  cover  the  cost of duplicating, shipping, and handling.  You
  1903.         may NOT distribute a licensed version of this software.  
  1904.  
  1905.         You  may  NOT  use,  copy, modify, sublicense, assign or transfer
  1906.         this  software  and  its license, or any copy or modification, in
  1907.         whole  or  in  part,  except  as  expressly  provided for in this
  1908.         license.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1916.  
  1917.